home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / demo / medit.zip / EDITOR.TXT < prev    next >
Text File  |  1994-10-10  |  10KB  |  268 lines
  1. Hello!
  2.  
  3. Thank you for contacting us and requesting information about the
  4. Magma Editor DLL and VBX, and the associated replacement classes for MFC,
  5. OWL, and zApp. Enclosed is information about the editor. It also tell you
  6. where you can download the editor from.
  7.  
  8. If you have any questions, please feel free to call or to e-mail us.
  9.  
  10. Regards,
  11.  
  12. Marc Adler
  13. Magma Systems
  14.  
  15.                  Magma Editor DLL/VBX for Microsoft Windows
  16.                  ------------------------------------------
  17.  
  18. (C) Copyright 1994 Magma Systems  All Rights Reserved
  19.  
  20. Magma Systems
  21. 15 Bodwell Terrace
  22. Millburn, New Jersey  07041
  23. USA
  24.  
  25. (201) 912-0192  (voice)
  26. (201) 912-0103  (fax)
  27. (201) 912-0668  (BBS, 9600-1200 N-8-1)
  28.  
  29. Compuserve : 75300,2062
  30.              To get to our conference, GO MAGMA
  31.  
  32. Bix        : 'magma'
  33.              To get to our conference, 'join magma'
  34.  
  35. Internet   : 75300.2062@compuserve.com
  36.              magma@bix.com
  37.  
  38.  
  39.  
  40. Introduction
  41. ------------
  42.  
  43. The Magma Editor DLL/VBX is an edit control which provides a powerful al-
  44. ternative to the standard Microsoft Windows edit control. The Magma Editor
  45. (ME for short) is a line oriented text editing kernel which can be con-
  46. trolled by an application through a series of messages or through a
  47. high-level C-like macro language. You can think of the ME DLL as being a
  48. "BRIEF in a box". 
  49.  
  50. The editor kernel provides the following features and enhancements over the
  51. standard Windows editor control : 
  52.  
  53. - The size of the text is limited by the amount of memory Windows
  54.   can globally allocate. On the other hand, the standard Windows
  55.   edit control is limited to 64K of text.
  56.  
  57. - Regular expression search and substitution
  58.  
  59. - Various block operations. Line marking, column marking, block
  60.   marking, and discontiguous line marking.
  61.  
  62. - Keyboard macros
  63.  
  64. - Messages to read and write to files.
  65.  
  66. - More varieties of cursor movement. Ability to jump to a specific line,
  67.   and to set bookmarks in the text.
  68.  
  69. - The ability to be in overstrike as well as in insert mode.
  70.  
  71. - Owner-drawn lines. You can draw out a line with different fonts and
  72.   efects, and even do syntax highlighting.
  73.  
  74.  
  75. The editing DLL is an editing kernel with no real associated user interface
  76. built in (no menus, few dialogs). It is based on the theory of the
  77. client/server model, where the editor is a "server" of editing functions.
  78. You can attach different user-interface related clients around the editor.
  79. It can be a control within a dialog box, it can function as a child window,
  80. or it can be a full-featured programmer's text editor.
  81.  
  82. The source code for the editor kernel is available at a reasonable price,
  83. so that you can modify and customize it for your own purposes.
  84.  
  85. It is our plan to release different user-interface shells (clients) around
  86. the editor DLL. The first shell we have written, the one which you see in
  87. MEWIN.EXE, was written in C using the standard Windows API calls. We also 
  88. have classes for the Microsoft Foundation Classes, Borland's Object Windows
  89. Library, Inmark's zApp, and Microsoft's Visual Basic. The source code for 
  90. all of the classes is available for downloading from the Magma Systems BBS
  91. or from various conferences on CompuServe. However, you need a copy of the
  92. editor DLL in order to use these classes.
  93.  
  94.  
  95. LIMITATIONS OF THE LITE VERSION
  96. -------------------------------
  97.  
  98. The version of the editor DLL and VBX which is available for downloading is 
  99. the Lite version. The Lite version of the Magma Editor DLL is limited to
  100. 300 lines of text. The full version of the DLL has no limitations
  101. whatsoever.
  102.  
  103.  
  104. FILES TO DOWNLOAD
  105. -----------------
  106.  
  107. MEDDLL.ZIP - the actual editor DLL (Lite version). You need this file in
  108. order to use any of the replacement C++ classes or any of the user
  109. interface shells.
  110.  
  111. MEDVBX.ZIP - a VBX version of the DLL
  112.  
  113. MEDMFC.ZIP or MEDIT.ZIP - contains information and documentation on the
  114. editor DLL. Contains a programmer's text editor called MEWIN.EXE, which is
  115. a wrapper around the DLL. Contains the CMagmaEdit and CMagmaEditView
  116. replacement classes for MFC.
  117.  
  118. MEDOWL.ZIP - classes for OWL 2.x. These fours classes, TMagmaEdit,
  119. TMagmaEditFile, TMagmaEditSearch, and TMagmaEditView, are replacements for
  120. the OWL TEditxxx family.
  121.  
  122. ZEDITOR.ZIP - classes and editor for the zApp Framework from Inmark
  123. Development.
  124.  
  125.  
  126. Future Enhancements
  127. -------------------
  128.  
  129. - Formatting support. Multiple fonts, bolding, italicizing, etc.
  130. - Ability to merge images
  131. (The above two enhancements will be ready by the middle of October 94)
  132.  
  133. - OCX versions
  134.  
  135. - Integration with a full 'C'-like scripting DLL. (The DOS version
  136.   of the ME Programmer's Text Editor had this feature.)
  137.  
  138. - Various modules which can hook into the scripting engine :
  139.     communications
  140.     report writing
  141.     mainframe access
  142.  
  143.  
  144. The CMagmaEdit Class
  145. --------------------
  146.  
  147. The CEdit editor class from the Microsoft Foundation Classes (MFC) has
  148. a limitation in that it cannot edit more than 64K bytes of text.
  149. The Magma Editor DLL overcomes this restriction by allowing you to edit
  150. text as large as the memory which Microsoft Windows will globally allocate.
  151.  
  152. We have created a new MFC class called CMagmaEdit which is inherited from
  153. the CEdit class. Most of the editing operations which are supported
  154. by the CEdit class are also supported by the CMagmaEdit class. In addition,
  155. the Magma Editor DLl has the following features :
  156.  
  157. - Regular expression search and substitution
  158.  
  159. - Various block operations. Line marking, column marking, block
  160.   marking, and discontiguous line marking.
  161.  
  162. - Keyboard macros
  163.  
  164. - Messages to read and write to files.
  165.  
  166. - More varieties of cursor movement. Ability to jump to a specific line,
  167.   and to set bookmarks in the text.
  168.  
  169. - The ability to be in overstrike as well as in insert mode.
  170.  
  171.  
  172. The CMagmaEditView Class
  173. ------------------------
  174.  
  175. The CEditView class from the Microsoft Foundation Classes is used as a
  176. wrapper around the CEdit class in order to create text editing windows
  177. which contain more capabilities than the standard CEdit class offers.
  178. For example, using the CEditView class, you can easily build an MDI-based
  179. text editor which incorporates search-and-replace and printing.
  180.  
  181. The Multipad sample application is a good demonstration of the CEditView
  182. class. In a few lines, one can build a full MDI-based text editor.
  183. We have enhanced Multipad so that it uses the CMagmaEditView and the
  184. CMamaEdit classes. We have also enhanced Multipad so that more information
  185. is displayed in the status line.
  186.  
  187. Using the CMagmaEditView class instead of the CEditView class is as
  188. easy as substituting the string 'CMagmaEditView' for 'CEditView'.
  189. The only change which we originally made in the Multipad source
  190. code to use the CMagmaEditView class was in the following statement :
  191.  
  192.     AddDocTemplate(new CMultiDocTemplate(IDR_TEXTTYPE,
  193.         RUNTIME_CLASS(CPadDoc), RUNTIME_CLASS(CMDIChildWnd),
  194.         RUNTIME_CLASS(CEditView)));
  195.  
  196.                was changed to
  197.  
  198.     AddDocTemplate(new CMultiDocTemplate(IDR_TEXTTYPE,
  199.         RUNTIME_CLASS(CPadDoc), RUNTIME_CLASS(CMDIChildWnd),
  200.         RUNTIME_CLASS(CMagmaEditView)));
  201.                               ^^^^^^^^^^^^^^
  202.  
  203. We have enclosed the full source code to the CMagmaEditView and 
  204. CMagmaEdit classes. The files of interest are MAGMAED.CPP and
  205. MAGMAED.HPP. You may feel free to enhance these files, but if
  206. you do, we at Magma Systems would appeciate hearing about any
  207. good changes you made.
  208.  
  209.  
  210. The OWL TEdit class
  211. -------------------
  212.  
  213. The TMagmaEdit family of classes are replacements for the TEdit family of
  214. classes which comes with OWL. The OWL TEdit class is only capable of edit-
  215. ing 32K of text. In fact, the edit.cpp source code always sets the maximum
  216. number of characters in an edit control to 30,000. The new TMagmaEdit clas-
  217. ses will let you edit an unlimited amount of text. In addition, you can use
  218. all of the new capabilities of the Magma Editor DLL. 
  219.  
  220. To use these new classes in your OWL application, you generally need to do
  221. only two "search-and-replace" operations. They are : 
  222.  
  223.   - Use the new include files. Use MEDT.H, MEDTFILE.H, MEDTSEAR.H and
  224.     MEDTVIEW.H in place of the existing EDIT.H, EDITFILE.H, EDITSEAR.H,
  225.     and EDITVIEW.H files.
  226.  
  227.   - Substitute the word 'TMagmaEdit' for 'TEdit' in your source. This
  228.     should take care of the four new classes, TMagmaEdit, TMagmaEditFile,
  229.     TMagmaEditSearch, and TMagmaEditView.
  230.  
  231. When you link your application, make sure to use the MEDITOWL.LIB
  232. library. Also, make sure that MAGMAED.DLL is in a directory which
  233. Windows ordinarily searches in order to locate DLLs.
  234.  
  235.  
  236.  
  237. Ordering Information
  238. --------------------
  239.  
  240. ME Editor DLL for Win 16, single developer's license      $249 US
  241. ME Editor DLL for Win 32, single developer's license      $249 US
  242. ME Editor DLL for Win16&32, single developer's license    $399 US
  243.  
  244. ME Editor DLL source code for Win16                       $450 US
  245. ME Editor DLL source code for Win32                       $450 US
  246. ME Editor DLL source code for Win16 & Win32               $600 US
  247. (for the source code, you must have a developer's license
  248.   for the corresponding platform)
  249.  
  250. Magma Scripting Engine and                    contact us for details...
  251.   support modules
  252.  
  253.  
  254. Please include $5.00 for shipping and handling within the United States,
  255. $10 Canada, $30 Europe, and $40 Asia and Pacific. $5 UPS COD charge.
  256.  
  257. Payment Terms :
  258.   Visa or Mastercard, personal or company check accepted. COD upon request.
  259. Payment must be made in US dollars and the check must be drawn on a US bank.
  260.  
  261.  
  262. Magma Systems is also the maker of the well-known MEWEL User Interface
  263. Library. MEWEL is a user interface library which implements the Microsoft
  264. Windows API (and MFC and OWL) on non-Windows platforms, including
  265. DOS text, DOS graphics, UNIX text, and (soon) Motif.
  266.  
  267.  
  268.